home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 076-100 / 092 / less / less.man < prev    next >
Text File  |  1995-03-13  |  17KB  |  398 lines

  1.  
  2.  
  3.  
  4.      LLLLEEEESSSSSSSS((((llll))))                     
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           less - opposite of more
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           lllleeeessssssss [[[[----ccccddddeeeeppppssssttttwwwwmmmmMMMMqqqqQQQQuuuuUUUU]]]] [[[[----hhhh_n]]]] [[[[----bbbb[[[[ffffpppp]]]]_n]]]] [[[[--
  13. --xxxx_n]]]] [[[[----[[[[zzzz]]]]_n]]]] [[[[++++_c_m_d]]]]
  14.           [[[[_n_a_m_e]]]] ............
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.           _L_e_s_s is a program similar to _m_o_r_e(1), but which allows
  18.           backwards movement in the file as well as forward movement.
  19.           Also, _l_e_s_s does not have to read the entire input file
  20.           before starting, so with large input files it starts up
  21.           faster than text editors like _v_i(1).  _L_e_s_s uses termcap, so
  22.           it can run on a variety of terminals.  There is even limited
  23.           support for hardcopy terminals.  (On a hardcopy terminal,
  24.           lines which should be printed at the top of the screen are
  25.           prefixed with an up-arrow.)
  26.  
  27.           Commands are based on both _m_o_r_e and _v_i.  Commands may be
  28.           preceeded by a decimal number, called N in the descriptions
  29.           below.  The number is used by some commands, as indicated.
  30.  
  31.      CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  32.           hhhh    Help: display a summary of these commands.  If you
  33.                forget all the other commands, remember this one.
  34.  
  35.           SSSSPPPPAAAACCCCEEEE
  36.                Scroll forward N lines, default one window (see option
  37.                ----zzzz below).  If N is more than the screen size, only one
  38.                screenful is displayed.
  39.  
  40.           ffff    Same as SSSSPPPPAAAACCCCEEEE.
  41.  
  42.           bbbb    Scroll backward N lines, default one window (see option
  43.                ----zzzz below).  If N is more than the screen size, only one
  44.                screenful is displayed.
  45.  
  46.           RRRREEEETTTTUUUURRRRNNNN
  47.                Scroll forward N lines, default 1.  If N is more than
  48.                the screen size, the entire N lines are displayed.
  49.  
  50.           eeee    Same as RRRREEEETTTTUUUURRRRNNNN.
  51.  
  52.           jjjj    Also the same as RRRREEEETTTTUUUURRRRNNNN.
  53.  
  54.           yyyy    Scroll backward N lines, default 1.  If N is more than
  55.                the screen size, the entire N lines are displayed.
  56.  
  57.           kkkk    Same as yyyy.
  58.  
  59.           dddd    Scroll forward N lines, default 10.  If N is specified,
  60.                it becomes the new default for all dddd and uuuu commands.
  61.  
  62.  
  63.  
  64.      Page 1                                           (printed 9/1/86)
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      LLLLEEEESSSSSSSS((((llll))))                     UUUUNNNNIIIIXXXX 5555....0000                      LLLLEEEESSSSSSSS((((llll))))
  72.  
  73.  
  74.  
  75.           uuuu    Scroll backward N lines, default 10.  If N is
  76.                specified, it becomes the new default for all dddd and uuuu
  77.                commands.
  78.  
  79.           rrrr    Repaint the screen.
  80.  
  81.           RRRR    Repaint the screen, discarding any buffered input.
  82.                Useful if the file is changing while it is being
  83.                viewed.
  84.  
  85.           gggg    Go to line N in the file, default 1 (beginning of
  86.                file).  (Warning: this may be slow if N is large.)
  87.  
  88.           GGGG    Go to line N in the file, default the end of the file.
  89.                (Warning: this may be slow if standard input, rather
  90.                than a file, is being read.)
  91.  
  92.           pppp    Go to a position N percent into the file.  N should be
  93.                between 0 and 100.  (This is possible if standard input
  94.                is being read, but only if _l_e_s_s has already read to the
  95.                end of the file.  It is always fast, but not always
  96.                useful.)
  97.  
  98.           %%%%    Same as pppp.
  99.  
  100.           mmmm_l   Followed by any lowercase letter, _l, marks the current
  101.                position with that letter.
  102.  
  103.           ''''_l   Followed by any lowercase letter, _l, returns to the
  104.                position which was previously marked with that letter.
  105.                All marks are lost when a new file is examined.
  106.  
  107.           ////ppppaaaatttttttteeeerrrrnnnn
  108.                Search forward in the file for the N-th occurence of
  109.                the _p_a_t_t_e_r_n.  N defaults to 1.  The _p_a_t_t_e_r_n is a
  110.                regular expression, as recognized by _e_d.  The search
  111.                starts at the second line displayed (but see the ----tttt
  112.                option, which changes this).
  113.  
  114.           ????ppppaaaatttttttteeeerrrrnnnn
  115.                Search backward in the file for the N-th occurence of
  116.                the _p_a_t_t_e_r_n.  The search starts at the line immediately
  117.                before the top line displayed.
  118.  
  119.           nnnn    Repeat previous search, for N-th occurence of the last
  120.                _p_a_t_t_e_r_n.
  121.  
  122.           EEEE [_f_i_l_e_n_a_m_e]
  123.                Examine a new file.  If the _f_i_l_e_n_a_m_e is missing, the
  124.                "current" file (see the NNNN and PPPP commands below) from
  125.                the list of files in the command line is re-examined.
  126.  
  127.  
  128.  
  129.  
  130.      Page 2                                           (printed 9/1/86)
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      LLLLEEEESSSSSSSS((((llll))))                     UUUUNNNNIIIIXXXX 5555....0000                      LLLLEEEESSSSSSSS((((llll))))
  138.  
  139.  
  140.  
  141.           NNNN    Examine the next file (from the list of files given in
  142.                the command line).  If a number N is specified (not to
  143.                be confused with the command NNNN), the N-th next file is
  144.                examined.
  145.  
  146.           PPPP    Examine the previous file.  If a number N is specified,
  147.                the N-th previous file is examined.
  148.  
  149.           ====    Prints the name of the file being viewed and the byte
  150.                offset of the bottom line being displayed.  If
  151.                possible, it also prints the length of the file and the
  152.                percent of the file above the last displayed line.
  153.  
  154.           ----    Followed by one of the command line option letters (see
  155.                below), this will toggle the setting of that option and
  156.                print a message describing the new setting.
  157.  
  158.           VVVV    Prints the version number of _l_e_s_s being run.
  159.  
  160.           qqqq    Exits _l_e_s_s.
  161.  
  162.           The following two commands may or may not be valid,
  163.           depending on your particular installation.
  164.  
  165.           vvvv    Invokes an editor to edit the current file being
  166.                viewed.  The editor is taken from the environment
  167.                variable EEEEDDDDIIIITTTTOOOORRRR, or defaults to _v_i.
  168.  
  169.           !!!! _s_h_e_l_l-_c_o_m_m_a_n_d
  170.                Invokes a shell to run the _s_h_e_l_l-_c_o_m_m_a_n_d given.
  171.  
  172.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  173.           Command line options are described below.  Options are also
  174.           taken from the environment variable LLLLEEEESSSSSSSS.  (The environment
  175.           variable is parsed before the command line, so command line
  176.           options override the LLLLEEEESSSSSSSS environment variable.  Options may
  177.           be changed while _l_e_s_s is running via the """"----"""" command.)  For
  178.           example, if you like more-style prompting, to avoid typing
  179.           lllleeeessssssss ----mmmm ............ each time _l_e_s_s is invoked, you might tell _c_s_h:
  180.  
  181.           sssseeeetttteeeennnnvvvv LLLLEEEESSSSSSSS mmmm
  182.  
  183.           or if you use _s_h:
  184.  
  185.           LLLLEEEESSSSSSSS====mmmm;;;; eeeexxxxppppoooorrrrtttt LLLLEEEESSSSSSSS
  186.  
  187.           ----ssss   The ----ssss flag causes consecutive blank lines to be
  188.                squeezed into a single blank line.  This is useful when
  189.                viewing _n_r_o_f_f output.
  190.  
  191.           ----tttt   Normally, forward searches start just after the top
  192.                displayed line (that is, at the second displayed line).
  193.  
  194.  
  195.  
  196.      Page 3                                           (printed 9/1/86)
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      LLLLEEEESSSSSSSS((((llll))))                     UUUUNNNNIIIIXXXX 5555....0000                      LLLLEEEESSSSSSSS((((llll))))
  204.  
  205.  
  206.  
  207.                Thus forward searches include the currently displayed
  208.                screen.  The ----tttt command line option causes forward
  209.                searches to start just after the bottom line displayed,
  210.                thus skipping the currently displayed screen.
  211.  
  212.           ----mmmm   Normally, _l_e_s_s prompts with a colon.  The ----mmmm command
  213.                line option causes _l_e_s_s to prompt verbosely like _m_o_r_e,
  214.                printing the file name and percent into the file.
  215.  
  216.           ----MMMM   The ----MMMM command line option causes _l_e_s_s to prompt even
  217.                more verbosely than _m_o_r_e.
  218.  
  219.           ----qqqq   Normally, if an attempt is made to scroll past the end
  220.                of the file or before the beginning of the file, the
  221.                terminal bell is rung to indicate this fact.  The ----qqqq
  222.                command line option tells _l_e_s_s not to ring the bell at
  223.                such times.  If the terminal has a "visual bell", it is
  224.                used instead.
  225.  
  226.           ----QQQQ   Even if ----qqqq is given, _l_e_s_s will ring the bell on certain
  227.                other errors, such as typing an invalid character.  The
  228.                ----QQQQ command line option tells _l_e_s_s to be quiet all the
  229.                time; that is, never ring the terminal bell.  If the
  230.                terminal has a "visual bell", it is used instead.
  231.  
  232.           ----eeee   Normally the only way to exit less is via the "q"
  233.                command.  The ----eeee command line option tells less to
  234.                automatically exit the second time it reaches end-of-
  235.                file.
  236.  
  237.           ----uuuu   If the ----uuuu command line option is given, backspaces are
  238.                treated as printable characters; that is, they are sent
  239.                to the terminal when they appear in the input.
  240.  
  241.           ----UUUU   If the ----UUUU command line option is given, backspaces are
  242.                printed as the two character sequence "^H".  If neither
  243.                ----uuuu nor ----UUUU is given, backspaces which appear adjacent to
  244.                an underscore character or sequences of a character
  245.                interleaved with backspaces are treated specially:  the
  246.                underlined or boldfaced text is displayed using the
  247.                terminal's hardware capability.  Note that the ----vvvv
  248.                option below superceeds both ----uuuu and ----UUUU.
  249.  
  250.           ----wwww   Normally, _l_e_s_s uses a tilde character to represent
  251.                lines past the end of the file.  The ----wwww option causes
  252.                blank lines to be used instead.
  253.  
  254.           ----dddd   Normally, _l_e_s_s will complain if the terminal is dumb;
  255.                that is, lacks some important capability, such as the
  256.                ability to clear the screen or scroll backwards.  The
  257.                ----dddd flag suppresses this complaint (but does not
  258.                otherwise change the behavior of the program on a dumb
  259.  
  260.  
  261.  
  262.      Page 4                                           (printed 9/1/86)
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.      LLLLEEEESSSSSSSS((((llll))))                     UUUUNNNNIIIIXXXX 5555....0000                      LLLLEEEESSSSSSSS((((llll))))
  270.  
  271.  
  272.  
  273.                terminal).
  274.  
  275.           ----pppp   Normally, _l_e_s_s will repaint the screen by scrolling
  276.                from the bottom of the screen.  If the ----pppp flag is set,
  277.                when _l_e_s_s needs to change the entire display, it will
  278.                clear the screen and paint from the top line down.
  279.  
  280.           ----hhhh_n  Normally, _l_e_s_s will scroll backwards when backwards
  281.                movement is necessary.  The ----hhhh option specifies a
  282.                maximum number of lines to scroll backwards.  If it is
  283.                necessary to move backwards more than this many lines,
  284.                the screen is repainted in a forward direction.  (If
  285.                the terminal does not have the ability to scroll
  286.                backwards, ----hhhh_0 is implied.)
  287.  
  288.           ----[[[[zzzz]]]]_n
  289.                When given a backwards or forwards window command, _l_e_s_s
  290.                will by default scroll backwards or forwards one
  291.                screenful of lines.  The ----zzzz option changes the default
  292.                scrolling window size to _n lines.  If _n is greater than
  293.                the screen size, the scrolling window size will be set
  294.                to one screenful.  Note that the zzzz is optional for
  295.                compatibility with more.
  296.  
  297.           ----xxxx   The ----xxxx command line option sets tab stops every _n
  298.                positions.  The default for _n is 8.
  299.  
  300.           ----bbbb[[[[ffffpppp]]]]_n
  301.                The ----bbbb command line option tells _l_e_s_s to use a non-
  302.                standard buffer size.  There are two standard (default)
  303.                buffer sizes, one is used when a file is being read and
  304.                the other when a pipe (standard input) is being read.
  305.                The current defaults are 5 buffers for files and 12 for
  306.                pipes.  (Buffers are 1024 bytes.)  The number _n
  307.                specifies a different number of buffers to use.  The ----bbbb
  308.                may be followed by ffff, in which case only the file
  309.                default is changed, or by pppp in which case only the pipe
  310.                default is changed.  Otherwise, both are changed.
  311.  
  312.           ----cccc   Normally, when data is read by _l_e_s_s, it is scanned to
  313.                ensure that bit 7 (the high order bit) is turned off in
  314.                each byte read, and to ensure that there are no null
  315.                (zero) bytes in the data (null bytes are turned into
  316.                "@" characters).  If the data is known to be "clean",
  317.                the ----cccc command line option will tell _l_e_s_s to skip this
  318.                checking, causing an imperceptible speed improvement.
  319.                (However, if the data is not "clean", unpredicatable
  320.                results may occur.)
  321.  
  322.           ----vvvv   The ----vvvv option tells less to print non-printing
  323.                characters in a visible way ala _c_a_t(1).  Control
  324.                characters are printed as ^X (the delete character
  325.  
  326.  
  327.  
  328.      Page 5                                           (printed 9/1/86)
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.      LLLLEEEESSSSSSSS((((llll))))                     UUUUNNNNIIIIXXXX 5555....0000                      LLLLEEEESSSSSSSS((((llll))))
  336.  
  337.  
  338.  
  339.                (octal 0177) is printed as ^?).  Characters with the
  340.                0200 bit set are printed as M- followed by the
  341.                character represented by the low order seven bits.
  342.  
  343.           ++++_c_o_m_m_a_n_d
  344.                If a command line option begins with ++++, the remainder
  345.                of that option is taken to be an initial command to
  346.                _l_e_s_s.  For example, ++++_G tells _l_e_s_s to start at the end
  347.                of the file rather than the beginning, and ++++/_x_y_z tells
  348.                it to start at the first occurence of _x_y_z in the file.
  349.                As a special case, ++++<_n_u_m_b_e_r> acts like ++++<_n_u_m_b_e_r>_g; that
  350.                is, it starts the display at the specified line number
  351.                (however, see the caveat under the gggg command above).
  352.                If the option starts with ++++++++, the initial command
  353.                applies to every file being viewed, not just the first
  354.                one.
  355.  
  356.      BBBBUUUUGGGGSSSS
  357.           When used on standard input (rather than a file), you can
  358.           move backwards only a finite amount, corresponding to that
  359.           portion of the file which is still buffered.
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.      Page 6                                           (printed 9/1/86)
  395.  
  396.  
  397.  
  398.